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In another MTB, the design principles used to implement the new 
library maintenance tool's were developed, and the strategy for 
centralizing the library organization information ana search 
procedures was outlined. 

This MTB describes the command interfaces for two new tools* 
Jibrary_map (lm> and I ibrary_print (Ipr). Iibrary_map replaces 
the us i_short_f ormat and ms i_gl oba l_f ormat commands by providing 
detailed status information for all entries in the Multics System 
Libraries. I ibrary_print performs a new library maintenance 
function, that of gathering together a group of printable library 
entries (like info segments, peruse text segments, bind lists, 
source segments, etc) into an MSF for print ing of f I ine. 

The MTB also describes the I ibrary_descriptor command, which can 
be used to set the name of the default library descriptor and to 
return information about the contents of a library descriptor. 
And finally, a cescription of the mul tics_l ibraries_ library 
descriptor is included. 

Thesa commands and the library descriptor will be includes in a 
oesign review of the new library tools, to be held in the near 
future. Note that the command which replaces msl__info has not 
been completely designed yet, and will be described by a 
subsequent MTB. 



Multics Project internal working documentation. Not to be 
reproouceo or distributed outsice the Multics Project. 
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Special Command 
Aoministrat ive/User Ring 



Ciaia' I ibrary__map, Im 

The library_map command selects entries from a library, and 
writes the status of these entries into a file suitable for 
dprinting. The entries in the file are alphabetized by primary 

name. 

A full range of status information can be included in the 
output by using the various output arguments. Besides the 
information returnea by the status command, the status can 
include object segment attributes reported by ob]ect_info_ and 
library-dependent information. 

The command uses a library descriptor data base and search 
program to define the structure, contents, and naming conventions 
of the library. Refer to the writeup for the 
I i brar y_oescr iptor_compi ler for more information about library 
descriptors. 



When no output arguments are specified, the choice of status 
information is controlled by the library search program for the 
particular library being mappea. For the Multics Offline 
Libraries (Hardcore, Salvager, BOS, and 355), the information 



includes: the names or. 

date of modification 

Salvager Libraries) the 

I ast instal I ed. For 

incljaesx the names on 

d3tes of modification and dumping; 

name of a link's target? ano its 

ring brackets. 



each library entry? it entry type? its 
ana path name? and (for Hardcore and 
id of the system in which the entry was 
other Multics Libraries, the information 
each library entry? its entry type? its 
its path name and the path 
current length, bit count, and 



Usaas 

I ibrary_map -search_namei-.. .-search_nameo- 
-cti _argl.-.. .-ct l_argo- -outputi.-. . .-outputQ- 

The search names, control arguments, and output 
described below appear in the command in any order. 



arguments 
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1) search_namel 

is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. If no 
search names are specified, then the default 
search names specified in the library descriptor 
are used. 

2) ctl_argi may be any of the following control arguments. 
-searcn_name search name 

-snm s_e.ar_£iL_Qafll£ 

is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. This 
control argument must be used when search nafflg 
begins with a minus (-) to distinguish the 
search,, Dame from a control argument. The 
- search_narae control argument may be used several 
times in the same command to specify several 
different search names. 

-I ibrary life 

-Id life life is a name which identifies the particular 
library or group of libraries which are to be 
searched when the library descriptor describes 
more than one library. The Multics star 
convention may be used to identify a group of 
libraries. The list of acceptable library names 
is defined by the library descriptor. More than 
one -library control argument may be specified to 
identify several groups of libraries. If the 
-library control argument is not specified* then 
the default library names specified in the library 
descriptor are used. 

-output_file iile. 

-of iil£ Ills is the path name of the output file in which 
the library map is to be generated. It may be a 
relative or absolute path name. If it does not 
end in a suffix of .map, then one is assumed. If 
the -output_file control argjment is not 
specified* then the map is generated in the 
I ibrary. map file created in the working directory. 
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-Header heading 

-ne Ufea.dJ.Qa 

Daafliaa is a character string which is placed on 
the header page of the output file to identify the 
contents of the file. If the string contains 
blankst then it must be enclosed in quotes. Only 
the first 120 characters of the string Mill be 
used. If the -heaoer control argument is not 
specified* then a default heading is placed on the 
heading page. (See No.f fiS below.) 

-footer fo pf jnq 

-fo laaiiiia 

lsaliHS. is a character string which is placed in 
the footing line of each output page to identify 
the library being mapped. If the string contains 
blanks* then it must be enclosed in quotes. Only 
the first <+5 characters of the string are usea. 
If the -footer control argument is not specified* 
then a default footing line is usea. (See N ote s 
bel ow. ) 

-parent* -par 

specifies that status information should be output 
for the parent of each I iorary entry. For 
example* information about an archive will be 
output when one of its components matches a search 
name. Normally* the output includes status for 
only those library entries which match a search 
name. 

-components 

-cmp specifies that status information should be output 
for all components of library archives which are 
identified by a search name. Normally* the output 
induces status for only those library entries 
which match a search name. 
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-retain specifies that library entries which await 
deletion from the library (as determined by the 
library search program) should be output* 
Normally* such entries are excluded. 

-I ibrary_descriptor Qg.in.aaie. 
-ids Le.ina.ffle. 

r et nai^e is the reference name of the library 
descriptor which describes the libraries to be 
searched. The descriptor identified by the 
r_e_f_n.affl£ will be found by using the search rules, 
which are documented in MPM Section 3.2. If the 
- I ibrary_descriptor control argument is not 
specifiea, then the default library descriptor is 
useo. (See Hoias be,ow «> 

-chase requests that any links which exist between a 
library link and its eventual target be omitted 
from the output. Normally, these intermediate 
links are included. 

-checK_archive, -ckac 

specifies that each library segment and archive 
component is to be checked to see if it is an 
archive segment, or an archived arcnive. If the 
-check_archive control argument is r>ot specified, 
checking for archives will be performed at the 
option of the library search program. 

-check_charac ter, -ckch 

specifies that each library entry is to be checked 
to see if its contents is unprintable (i.e., 
contains non-ASCII characters). In addition, 
unprintable segments are checked to determine if 
they are peruse_text object segments. If the 
-Check_character control argument is not 
specif iea, character checking will be performea at 
the option of the library search program. 

-check_ob J ect , -ckob 

specifies that each library segment and archive 

component is to be checked to see if it is an 

object segment. If the -check_obJ ect control 

argument is not specified, object checking will be 

performed at the option of the library search 
program. 
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-check* -ck 

specifies that all there types of checking 
(archive* character, and object) are to be 
per formed. 

3) OJtputi may be any of the following ojtput arguments. 
These arguments specify which status information 
is to be returnee! for each library entry which 
appears in the map. If no output arguments are 
specified, then default information is output for 
each library entry, under control of the library 
search program. 

-default, -dft 

requests that the default information for each 
library entry be output, in add ition la output 
requested by any other output arguments. 

-all, -a requests that all available status information be 
output. 

-name, -nm requests that all of the names on each library 
entry be output. 

-first, -ft requests that the first name on each library entry 
be output. 

-match requests that the names on each I iorary entry 
which match any of the search names given in the 
I ibrary_map command be output. 

-type, -tp requests that the type of each library entry 
(link, segment, airectory, archive, archive 
component, multi-segment file, or msf component) 
be output. 

-oarent_path, -pp 

requests that the path name of the parent of each 
library entry be output. 

-link, -Ik requests that the path name of the target of a 
library link be output. 
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-date, -dt requests that the date modified* date used, date 
entry modified, ana aate dumpea for each library 
entry be output. For an archive component, the 
aate entry modified corresponds to the date 
component updated. 

-date_modi f ied, -dtm 

requests that the aate on which each library entry 
was last modified be output. 

•aate_used, -dtu 

requests that the date on which each library entry 
was last used be output. 

•date_entry_modif iea, -dtem 

requests that the date on which the entry for a 
library link, segment, directory, archive, or 
multi-segment file was last modified, or the aate 
on which a library archive component was last 
updated into its archive, be output. 

■aate_aumpea, -dta 

requests that the date on which a library entry 
was last dumped onto a backup tape be output. 

• I ength, - I n 

requests that the current length, records usea, 
and bit count or ms f indicator of each library 
entry be output. The records used are included 
only when different from the current length. 

•current.) ength, -cln 

requests that the current length of each library 
entry be output. 

■recoras_usea , -ru 

requests that the number of records occupied by 
each library entry be output. For a multi-segment 
file, the value includes only those records used 
Dy the ms f directory. Those occupied by the ms f 
components are included in the map entry for each 
component. If both the current length and recorcs 
used have been requested, then the records used 
will be omitted from the output if equal to the 
current I ength. 
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access 


mode to 


each 


1 ibrary 


ent ry* s 


ring 


access 


mode to 


each 



-bi t__count , -be 

requests that the bit count of each library 
segment* archive* archive component* and msf 
component be output* along with the msf indicator 
of each library multi-segment file. 

-access* -acs 

requests that the user's 

I ibrary entry* and each 

brackets be output. 

-■node* -md requests that the user's 
library entry be output. 

-~ing_bracket s* -rb 

requests that the ring brackets of each liorary 
entry be output. 

-contents* -ct 

requests that the contents of each library entry 
be checked to determine whether the entry is an 
archive* an object entry (i.e.* an object segment 
or archive component), a peruse text object entry, 
or another type of unprintable entry. For each 
object entry* the following information is outputt 
date compiled or bound? compiler or binder 
version number? compiler options; and object 
entry attributes. The compiler version number and 
printable character length of each peruse text 
object entry is output. An indication is output 
for each unprintable entry. (See N.Q.JL&S. below.) 

-date_compi I ec, -dtc 

requests that the date compiled be output for each 
library (bound or unbound) object entry. (See 
tifll.6.5. below.) 

-compi I er_version -cv 

requests that name ana version information be 
output for the compiler of each object entry. 
(See N, o f 65, below.) 

-compi ler_opt ions* -co 

requests that the options used when compiling each 
object entry be output. (See Mal£S below.) 
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-ooject_inf o, -oi 

requests that the attributes of each object entry 
be output. Attributes includes bound object 
indicator? old object format indicator; 
non-stanaaro object format indicator! and the 
octal value of any call limiter, (See Not es 
bel ow. ) 

-character, -ch 

requests that an indication ba output for each 
I iDrary entry whose contents is unprintable (i.e., 
contains non-ASCII characters). (See N ote s^ 
bel ow. ) 

-3eruse_text, -pt 

requests that the compiler version number and 
printable character length be output for each 
peruse text object entry. (See Nflt&S below.) 

-3evice_id* -die 

requests that the type of aevice on which the 
library entry is storea be output. 

-copy_swi tch, -cs 

requests that the copy switch setting for the 
I ibrary entry be output. 

-offset requests that the offset (from the beginning of 

its containing segment) of the contents of an 

archive component be output. The offset is an 
octal word count. 

-jnique_id, -uic 

requests that the unique identifier of the library 
entry be output in octal. 



•error, -er 



requests that any error which occurred while 
obtaining status be indicated by the appropriate 
error message. The message appears in the map 
entry for the parent of the library entry in which 
the error occurred. 
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- I eve I , - 1 v 

requests that a level number be output for each 
library entry. The level number indicates the 
relationship between a library entry anc its 
components. For example* the map entry for an 
archive might appear in the map at level l* and 
the archive's components might appear at level 2. 
Normally* the level is indicated only by relative 
indentation of entry names. 

-new_line* -nl 

requests that a line be skipped before writing the 
status of each level l entry in the map. This 
line makes it easier to identify level 1 entries. 
Normally* no lines are skipped between entries. 

biaias 

If the output file already exists* it is truncated and 
rewritten. Thus* if several library_map commands are executed in 
the same working directory (by the same process* or tiy different 
processes) without including an -output_file control argument* 
then the output of all but the last command is overwritten. In 
such cases* the -output_file control argument should be specified 
to orevent the output of the last command from overwriting the 
outpjt of preceding commanos. 

If the -heaaer b.e.aaiQQ, control argument is specified* then 
the tiaastiast character string is centered on the header page of 
the output file beneath the lines* 

Map of the qg. Entries 

of the 

The tl£,aj£tiQs character string should be worded with this in mind. 
For example: 

Map of the 35 Entries 

of the 

Standard Service System Bind Listing Library 
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If io -header control argument is specified* then a default 
heading line is constructed by concatenating the library names* 
as shown below: 

Map of the 35u Entries 

o f the 

Libraries 

s tana ard_ser vice, list* unbundled. J ist, 
tools, list, author_maintained. I ist, network. list 

If the -footer IftOtiaa control argument is specified* then 
the footing line appears at the lower left corner of each output 
page (except the header page)* along with the name<s> of the 
Jewel 1 entries appearing on that page* and the page number. If 
the -footer control argument is omitted* then the library names 
are concatenated together as with the default heading line* and 
usea as the default footing line. 

In order for some output arguments to take effect* 
information in addition to simple status must be available. 
Therefore, some output arguments automatically invoke certain of 
the control arguments. For example, the -contents output 
argunent requires that archive* character* and object checking be 
performed, and therefore invokes the -check control argument. 
Similarly, -date_compi I eo» -compi 1 er_version» -compi I er_options» 
and -ob)ect_info output options invoke the -check_ob Ject control 
argument; and the -character and -peruse_text output arguments 
invoKe the -check_character control argument. The -all output 
argument invokes the -parent* -default* and -check control 
arguments* as well as ail of the output arguments. 

The default library name(s) and search name(s) used for the 
library.map commana are aefineo in the library descriptor for the 
libraries being mapped. The I i brary_descriptor command can be 
used to print these default values. In particular, the default 
values for the default library descriptor can be printed by 
typing the commands 

Ids default I iorary_map 

Refer to the writeup on the I ibrary_descriptor command for more 
detai I s. 
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When no -library_descriptor control argument is given in the 
command, the aef suit library descriptor is used. The name of the 
default library descriptor can be set and printed with the 
library_aescriptpr commanq. The initial default library 
descriptor describes the Multics System Libraries. 

The command 



-of 



1 ibrary_map -lb info.* -lb 
documentation 



peruse_text. into **.info **.pt 



creates the documentation. map file in the working directory, 

which contains a map of the entries in the info.* and 

peruse_text.* libraries which match the search names **.info or 
**«Qi» The command 



I ibrary_map -lb onl ine.* ** -of oril ine — dtd -df t 

creates the online. map file which contains a map of all of 
entries in the online.* libraries. Each map entry includes 
date dumped* as well as whatever default information 
specified by the library search program. The command 



the 
the 
was 



I ibrary„map 

creates a map in the library. map file of the working directory 
which contains status for those entries in the default library 
(or I ibraries) which match the default search name(s). These 
defaul t values are specified by the default library descriptor 
data base. 
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N.ai£* I ibrary_print , I pr 

The 1 ibrar y_print commanc selects printable entries from a 
library, ana writes the contents of these entries into a file 
suitable for aprinting. Printable library entries are those 
whicn contain only ASCII characters. The ASCII portion of peruse 
text object segments is also printable. Thus printable entries 
can include source segments* listings, bind files, info segments, 
peruse text object segments, exec_com control segments, printable 
multi-segment files, etc. 

The entries in the print file are alphabetized by primary 
name. Each entry is preceded by a header which lists the status 
of the entry. An index of all entry names appears at the end of 
the file. 

The command uses a library oescriptor data base and search 
program to define the structure, contents, and naming conventions 
of the library. Refer to the writeup for the 
libr3ry_aescriptor_compiler for more information about library 
descriptors. 

When no output arguments are specified, the status 
information which is included in the header of each entry is 
controlled by the library search program for the particular 
library being printed. For the Multics System Libraries, the 
information includes* the names on the library entry? its entry 
type? its date of moaif icat ion; its path name? and (for 
Haracore and Salvager Libraries) the id of the system in which 
the entry was last installed. 

I ibrary_print -search_namei- . . * -search_nameQ- 
-ct l_arg;L-. . ,-ct l_argQ- -output!- • . .-out put q- 



The search names, control arguments, ana output 
described below appear in the command in any order. 



arguments 



1) search_namei 



is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. If no 
search names are specified, then the default 
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search names specified in the library descriptor 
are used. 

2) ctl_argi may be any of the following control arguments. 

-search_name search name 

-snm __a.r_c.__D.ajie. 

is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. This 
control argument must be used when Sfi.ac.SLtl_Qa.JDe. 
begins with a minus (-) to distinguish the 
___________ from a control argument. The 

-search_name control argument may be used several 
times in the same commano to specify several 
different search names. 

- 1 ibrary i_b 

-lb lib. lib. is a name which identifies the particular 
library or group of libraries which are to be 
searched when the library descriptor describes 
more than one library. The Multics star 
convention may be used to identify a group of 
libraries. The list of acceptable library names 
is defined by the library descriptor. More than 
one -library control argument may be specif iea to 
identify several groups of libraries. If the 
-library control argument is not specified* then 
the default library names specified in the library 
descriptor are used. 

-output_f i le fj le 

-of Iil_ I ll s is the path name of the output file in which 
the library print out is to be generatea. It may 
be a relative or absolute path name. If it does 
not end in a suffix of .print, then one is 
assumed. If the -output_file control argument is 
not specified, then the print out is generated in 
the I ibrary. print file created in the working 
directory. 
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-header hje.ad.iog 

-he he.a.Hlo.9. 

Qfeafliaa is a character string which is placec on 
the header page of the output file to identify the 
contents of the file. If the string contains 
blanks* then It must be enclosed in quotes. Only 
the first 120 characters of the string will be 
usea. If the -heaaer control argument is not 
specified, then a default heading is placed on the 
heading page, (See Malfis below.) 

-footer laalioa 

- f o tsLSilLna 

loaLLaa. is a character string which is placed in 
the footing line of each output page to identify 
the library being printed. If the string contains 
blanks, then it must be enclosed in quotes. Only 
the first k5 characters of the string are used. 
If the -footer control argument is not specified* 
then a default footing line is usea. (See N.a±£S. 
bei ow. } 

-parent, -par 

specifies that the contents of the parent of each 
library entry should be output, rather than the 
library entry itself. For example* the contents 
of an archive will be output when one of its 
components matches a search name. Normally, only 
those library entries which match a search name 
are output. 

-components 

-cmp specifies that the contents of each component of a 
library archive which matches a search name is to 
be output individually. Normally, only matching 
components of the archive are output (or if no 
components match* the entire archive is output). 
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-retain specifies that library entries which await 
Deletion from the library (as determined by the 
library search program) should be output. 
Normally* such entries are excluded. 

-I i brary_descriptor ret nane 

-ids csJuamfi 

DSiCLflmfe is the reference name of the library 
Descriptor which Describes the libraries to be 
searched. The descriptor identified by the 
C&lQaafi will be found by using the search rules, 
which are documented in MPM Section 3.2. If the 
- I ibrary_descrip tor control argument is not 
specified, then the default library descriptor is 
used. (See WfltftS below.) 

-chase requests that any links which exist between a 
library linK and its eventual target be omitted 
from the status information in the header. 
Normally, these intermediate links are included. 

-check_archive» -ckac 

specifies that each library segment and archive 

component is to be checked to see if it is an 

archive segment, or an archived archive. If the 
-check_archlve control argument is not specified, 

checking for archives will be performed at the 
option of the library search program. 

-check_charac ter, -ckch 

specifies that each library entry is to be checked 
to see if its contents is unprintable (i.e., 
contains non-ASCII characters). In addition, 
unprintable segments are checked to determine if 
they are peruse_text ooject segments. If the 
-check_character control argument Is not 
specified, character checking will be performed at 
the option of the library search program. 

-check_obJect , -ckob 

specifies that each library segment ano archive 
component is to be checked to see if it is an 
object segment. If the -check_obJ ect control 
argument is not specified, object checking will be 
performed at the option of the library search 
program. 
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-checkt -ck 

specifies that al I there types of checking 
(archive* character, and object) are to be 
performed. 

3) ojtputi may be any of the following output arguments. 
These arguments specify which status information 
is to be returnee in the heaaer of each library 
entry which appears in the print out. If no 
output arguments are specified, then default 
information is output for each library entry, 
under control of the library searcn program. 

-default, -dft 

requests that the default information for each 
library entry be output, in fi&iiLLaa la output 
requestea by any other output arguments. 

-all, -a requests that all available status information be 
output. 

-name, -nm requests that all of the names on each library 
entry be output. 

-first, -ft requests that the first name on each library entry 
be output. 

-natch requests that the names on each library entry 
which match any of the search names given in the 
I ibrary_print command be output. 

-type, -tp requests that the type of each library entry 
(link, segment, directory, archive, archive 
component, multi-segment file, or msf component) 
be output. 

-parent_path, -pp 

requests that the path name of the parent of each 
library entry be output. 

-link, -Ik requests that the path name of the target of a 
library link be output. 

-date, -dt requests that the date modified, date used, date 
entry modified, and date dumped for each library 
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entry be output. For an archive component* the 
date entry modified corresponds to the date 
component updated. 

-date_modif iec, -dtm 

requests that the date on which each library entry 
was last modified be output. 

-3ate_usea, -otu 

requests that the date on which each library entry 
was last used be output. 

- 3ate_entry_fflocif led, -dtem 

requests that the date on which the entry for a 
library linK, segment* Directory* archive. or 
mul ti-segment file was last modified, or the date 
on which a library archive component was last 
updated into its archive* be output. 

-date_dumped, -dtd 

requests that the date on which a library entry 
was last oumped onto a backup tape be output. 

-I ength, - In 

requests that the current length, records used, 
ana bit count or msf indicator of each liorary 
entry be output. The records used are included 
only when different from the current length. 

-current,! ength, -cln 

requests that the current length of each library 
entry be output. 

-r ecords_used, -ru 

requests that the number of records occupied by 
each library entry be output. For a mul ti-segment 
file, the value includes only those records used 
by the msf directory. Those occupied by the msf 
components are incluoea in the header information 
for each component. If both the current length 
and records used have been requested, then the 
records usee will be omitteu from the output if 
equal to the current length. 

-oit_count, -be 

requests that the bit count of each library 
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segment* archive* archive component, and msf 
component be output, along with the msf Indicator 
of, each library multi-segment file. 

-access,' -acs 

requests that the user r s access mode to each 
I ibrary entry, ano each library entry's ring 
brackets be Output. / 

-node* -md peguests that the user's access mode to each 
I ibrary entry be output. 

-ring^brackets, -rb 

requests that the ring brackets of each library 
entry be output, 

-contents, -ct 

requests that the contents of each library entry 
be checked to determine whether the entry is 
printable. The compiler version number and 
printable character length of each peruse text 
object entry is output, other entries are merely 
checked for printabil ity, (See Njaias below.) 

-peruse w text» -pf 

requests that the compiler version number and 
printable character length be output for each 
peruse text object entry. (See fiftlaa below.) 

-device_id, -did 

requests that the type of device on which the 
library entry is stored be output* 

*copy_switch, -cs 

requests that the copy switch setting for the 
I ibrary entry be output. 

-offset requests that the offset (from the beginning of 
its containing segment) of the contents of an 
archive component be output. The offset is an 
octal word count. 

-unique_id» -Uid 

requests that the unique identifier of the library 
entry be output in octal. 
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-error, -er 



-I ewe i * -I v 



requests that any error which occurred while 
obtaining status be indicated by the appropriate 
error message* The message appears in the header 
information for the parent of the library entry in 
which the error occurred* 



requests that a level number be output for each 
library entry* The level number indicates the 

relationship between a library entry and its 

components* For example* the header of the entry 

for an archive might have the archive at level 1 

and the archive's components at level 2. 

Normally* the level is indicated only by relative 
indentation of entry names* 



fcLalas 



If the output file already exists* it is truncated and 
rewritten. Thus* if several library_print commands are executed 
in the same working directory (by the same process* or by 
aifferent processes) without including an -output_f I le control 
argument, then the output of all but the last command is 
overwritten. In such cases* the -output_file control argument 
should be specified to prevent the output of the last command 
from overwriting the output of preceding commands* 

If the -heaaer heading control argument is specified* then 
the h eadin g character string is centered on the header page of 
the output file beneath the lines* 

Print Out of the qq Entries 

of the 

The ft fid fl ing character string shoulc be worded with this in mines. 
For example* 

Print Out of the 35 Entries 

of the 

Standarc Service System Bind Listing Library 
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If no -header control argument is specified, then a default 
heading line is constructed by concatenating the library names, 
as shown below: 

Map of the 35(j Entries 

of the 

Libraries 

s tan dard_ser vice .list, unbundl ed. I ist, 
tools, list, author_raaintained. I ist, network. list 

If the -footer Jppting control argument is specified, then 
the foot Jtn.9 line appears at the lower left corner of each output 
page {except the header page), along with the name(s) of the 
level l entries appearing on that page, and the page number. If 
the -footer control argument is omitted, then the library names 
are concatenated together as with the default heading line, and 
used as the default footing line. 

In order for some output arguments to take effect, 
information in addition to simple status must be available. 
Therefore, some output arguments automatically invoke certain of 
arguments. For example, the -contents output 



control 



rguient requires that archive, character, and object checking be 
erformeo, and therefore invokes the -check control argument. 



argument invokes the 



the 

a 

P 

Similarly, the -peruse_text output 

-check_character control argument. The -all output argument 

invokes the -default and -check control arguments, as well as all 

of the output arguments. 

The default library name(s) and search name(s) used for the 
I ibrary_print command are defined in the library descriptor for 
the libraries being printed. The I ibrary_descriptor command can 
be used to print these default values. In particular, the 
default values for the default library descriptor can be printed 
by typing the commands 



las defaults library_print 

Refer to the writeup on the I ibrary_descriptor command for more 
aetai I s. 
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When no - I ibrary_descr iptor control argument is given in the 
command, the default library descriptor is used. The name of the 
defauil t library descriptor can be set and printed with the 
I ibrary_cescriptor commano. The initial default library 
descriptor describes the Multics System Libraries. 

The command 

I ibrary_print -lb info.* -lb peruse_text.inf o **.info **.pt 
-of documentation 

creates the documentat ion. print file in the working directory, 
which contains a print out of the entries in the info.* and 
peruse_text.* libraries which match the search names **.info or 
**.pt. The commano 

I ibrary_print -lb onl ine. ob J ect **.bind -of online -dtd -dft 

creates the online. print file which contains a print out of ail 
of the bind files, in the online object lioraries. Each entry 
includes a header with the date dumped* as well as whatever 
aefault status information was specified by the library search 
program. The command 

I ibrary_print 

creates a print out in the I ibrary. print file of the working 
directory which contains the contents of those entries in the 
default library (or libraries) which match the default search 
name(s). These default values are specified by the default 
library descriptor data base. 
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tiam£S J ' ibrary_descriptor» Ids 

The I ibrary.descriptor command controls the use of library 
descriptors by library maintenance commands* and proviaes 
information about the contents of a library descriptor. The 
commands can print and set the name of the I ibrary descriptor 
which is usea by default in library maintenance commands when no 
library descriptor is explicitly specified? can print the path 
names of the library roots which are associated with one or more 
library names* can print detailed information about one or more 
of the library roots defined by the descriptor; and it can print 
the default library and search names associated with each library 
command. 



The library descriptor is 



data base which* with its 



associated library search program* defines 
contents* and naming conventions of the library. 
writeup for the I ibrary_descriptor_compi Jer for 
aoout library descriptors. 



the structure* 

Refer to the 

more information 



Uaaaa 

I ibrary_descriptor Key -options- 

The keys and their options are aescribed in the sections which 
follow. 



Kftfci 



name 



The name key returns the name of the default library 
descriptor which is currently being used. I ibrary_descriptor may 
be invoked as an active function when the name key is used. 

Uaaas. 

I ibrary_descriptor name 

&£¥$ set_name 

The set_name key sets the name of the default library 
descriptor. 
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Uaaas. 



I ibrary_cescr iptor set_name refname 



1) re f name 



is the reference name of the new default library 
descriptor. The descriptor identified by refname 
is searched for according to the search rules* 
which are documented in MPM Section 3«2» 



&£*: path 

The path key returns the path name of the library root(s) 
whicn are identified by one or more library names. 
I ibrary_descriptor may be invoked as an active function when the 
path key is usee. 

U&aaa 

I ibrary_descriptor path lib_namel ... lib_nameQ -ctl_argl.- 

1) lib_namei is a name which identifies the particular library 
or group of I ibraries whose paths are to be 
returned. The Multics star convention may be used 
to identify a group of libraries. 



2) ctl_argl 



may be the following optional control argument. 



-I ibrary_descriptor cef fl d Mft 

-ids cainams 

refname, is tne reference name of the library 
descriptor which defines the library roots whose 
path names are to be returned. The cescriptor 
identified by cfi-lQaas wiil be found by using the 
search rules* which are documented in MPM Section 
3.2. If the - I ibrary_oescr iptor control argument 
is not specif iedt then the default library 
cescriptor is usea. 

&£*J defaults 

The defaults key prints the default liorary name(s) and 
search name(s) associated with one or more of the library 
maintenance commands. 
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I ibrary_oescriptor aef suits 
-ctl _argi- 



•commandl- 



-commanaQ- 



1) commandi. 



is the name of the library maintenance command 
whose default library ana search names are to be 
printed. If no command names are given* the 
default for all of the library maintenance 
commands will be printed. 



2) ctl_argi 



may be any of the optional control arguments 
aefined for the path Key. 



&&.*.'< 



roots 



The roots Key prints detailed information aDout one or more 
library roots on the user's terminal. The information includes 
the names on each library root, its path name, ana its type. 



Usasa 



I ibrary_descriptor roots I ib_namel ... I ib_nameo. -ctl_argl- 
ctl_argQ- 



1) lib_namei 



is a name which iaentifies the particular library 
roots about which information is to be printed. 
The Hultics star convention may be used to 
iaentify a group of libraries. 



2) -ctl_argjL may be one of the following control arguments. 

-name, -nm specifies that all of the names defined for the 
library root are to be printed. Usually, only the 
first name and names which match the lib_namei 
arguments are printed. 

-I ibrary_descriptor r ef name 
-I ds LeJLQajae. 

as above. 



c Copyright 197**, Massachusetts Institute of Technology 

and Honeywell Information Systems Inc. (END) 



(This page Intentionally left blank) 



MTB- 133 
MULTICS LIBRARY 



MAINTENANCE MANUAL 



i 



i 



I mul t ics_li braries_ J 



I 



.1 



Data Base 
Administrative/User Ring 

ll/G8/7<t 



N_ai£t mul tics_l ibraries_ 

This data base is the library descriptor for the Mul tics 
System Libraries. Like all library descriptors, it defines the 
roots of the Mul tics System Libraries* the names by which library 
roots can be referencecs in the various library maintenance 
commands* and the default library names and search names used for 
each of the library maintenance commands. 

Refer to the writeup on library descriptors for a definition 
of the internal structure of this (and other) library 
oescr* iptors. Refer to the writeup on the 
library_aescriptor_compi ler for the definition of the Library 
Description Language which is used to define the contents of the 
library descriptor. 

Ib£ ElulliSLS LibXeCJLfcS. 

The Multics System is composed of the "logical libraries" 
listed below. Each of the libraries is* in turn* composed of 
several directories containing the different Kinds of library 
segments (source, object* bind lists* info, include, peruse_text) 
which are storec in the libraries. A library maintenance command 
can reference an entire logical library by name* or one or more 
of its directories. 



Note that the logical 
does not map directly onto the 
the Multics Storage System. 
tools can reference ail of the 
logical library names. 



library organization defined below 

physical library organization in 

However, ihe library maintenance 

physical libraries through their 



stanaarc_l ibrary , std 

the library which contains most user commands and 
subroutines, and the system support routines for these 
commands and subroutines. 



unbund led_l ibrary, unb 

the library which contains Honeywell 
other unbundled software. 



programmed products and 



tools_library* tools 

the library which 
administrat ive commands 



contains system 
ana subroutines. 



maintenance and 
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insta 1 lation_l ibrary, inst 

the library which contains installation-maintained software. 

user_i ibrary, user 

"the library which contains user-maintained software. 

network_l ibrary, net 

the library which contains the software for linking the 
Multics System to the ARPA Network. 

supervisor.! ibrary, sup 

the library which contains the supervisor (ring 0) segments 
of the Multics System. 

sat vager_l ibrary » salv 

the library which contains the Multics Storage System 
salvager commanas ana subroutines. 

boot I oad_l ibrary , bos 

the library which contains the commands ana suoroutines of 
the Bootload Operating System. 

data_net_355_l ibrary, 355 

the library which contains the commanas ana subroutines of 
the Data Net 355 Operating System. 

Each of the above logical libraries contains one or more of the 
following logical directories. 

source* s 

the directory containing the source language segments which 
can be translated into the object segments of the library. 

ob J ect t o 

the oirectory containing the obi ect segments produced by 
translating the source segments of the library. 

lists, I 

the oirectory containing the listings produced by binding 
several object segments together into a bound segment. 

execution, x 

the oirectory containing bouna ana unbound object segments 
and data bases used by users of Multics. These directories 
are general ly incl uded in the search rules of some or all 
users. 
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bounoi_comp, be 

the directory containing 
into bound segments. 



the archives wnich may be bound 



info* i 

the directory containing information segments which can be 
printed on the user's terminal under control of the help 
commancu These segments describe the commands and 
subroutines included in the library* and outline library 
problems* upcoming changes* etc. 

peruse_text, pt 

the directory containing the peruse_text object segments 
which describe the commanas ana subroutines of the library. 
Selected portions of these segments may be printed on the 
user's terminal under control of the peruse_text command. 

incljae* incl 

the directory containing source segments which are included 
as part of several other source segments* under the control 
of a language translator. 

One or more libraries or directories may be referenced in a 
library maintenance command by giving the appropriate library or 
directory name. 

. An entire library can be referenced by giving one of the 

library names listed above. 
. A particular type of directory can be referenced across all 

libraries by giving one of the directory names listed above. 
. A particular directory within a specific library can be 

referenced by giving a 2-coraponent name of the form* 

I ibrary.airectory. For example* standard_l ibrary. source or 

instal lation_l ibrary. Info . 
. The star convention may be used to identify several 

libraries or directories. For example* +. source or ** . 
. Two groups of libraries can be referenced by the following 

names s 

onl ine_l ibraries* on 

standard_l ibrary* unbunal ea_l ibrary* tool s_l ibrary, 
instal lation_l ibrary* user_l ibrary* network_l ibrary. 
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offline libraries* off 

supervisor.! ibraryt sal vager_l ibrary* boot I oad.l ibrary » 
data_net_355_l ibrary. 

Not all of the libraries listed above contain each type of 
directory. The following lists show which I ibrary .directory 

combinations are valid. 



std. source 
sto. object 
sto. I ists 
std. execut i on 
sta. info 
std.peruse_text 
std. incl ude 

inst .source 
inst .obj ect 
inst . I ists 
inst .execut ion 
inst. info 
inst .peruse_text 
inst . include 



unb. source 
uno. object 
unb. I ists 
unb. execution 
unb. info 
unb.peruse_text 
unb. include 

user. source 
user. object 
user. I ists 
user. execution 
user. info 
user. peruse_ text 
user. incl ude 



tools. source 
tools. object 
tools. I ists 
tool s. execution 
tools. info 
tools.peruse_text 
tools. incl ude 

net .source 
net. object 
net. I ists 
net. execut ion 
net. info 
net.peruse_text 
net. incl ude 



sup. source 
sup. bouna.comp 
sup.ob J ect 
sup. incl ude 

bos. source 
bos.obj ect 
bos. incl ude 



sal v. source 
sal v.bouno_corap 
sal v. object 
sal v. incl ude 

355. source 
355. object 



Some examples of library names are: 

onl ine_l ibraries 

off .source 

standard. I ibrary. info 

inc I ude 

user.x 

network.! ibrary. I ists 

Pt 

stc. ?????? 
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* 

The table below shows the default library names and search 
names used by each of the library maintenance commands. Commands 
which have no default values are not shown in the taole. 



kajaaajao. 

I ibrary_map 

1 ibrary_print 



Q£laiiiJL_Lifec.acy._iUfli£ Qalaull_.Saa.cttL.Mame 
on I ine__l i braries ** 
info * ■*■ .info 



I ibrary_cl eanup on I ine_l ibrar ies 



I'?'?'?'?'?'?'?'?'?'?'?'?'? 
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